home *** CD-ROM | disk | FTP | other *** search
/ Aminet 31 / Aminet 31 (1999)(Schatztruhe)[!][Jun 1999].iso / Aminet / dev / basic / CNKI.readme < prev    next >
Text File  |  1999-05-02  |  5KB  |  156 lines
  1. Short:    Converts a brush/animbrush to .CNK file
  2. Author:   chris@addnet.demon.co.uk (Chris Deeney)
  3. Uploader: chris@addnet.demon.co.uk (Chris Deeney)
  4. Version:  V1.0
  5. Type:     dev/basic
  6. Requires: dev/basic/Mildred.lha
  7.  
  8. CNKI File Format By Chris Deeney 1999
  9.  
  10.  
  11. Introduction:
  12. ------------
  13. CNKI is a file format designed to make chunky shapes compact and easy
  14. to load in your programs.
  15.  
  16. This archive contains:
  17.  
  18. CNKI.readme          3651  bytes
  19. BrushConvertor       62232 bytes
  20. CNKI.bb2             3067  bytes
  21. CNKI.bb2.xtra        1222  bytes
  22. CNKI.ascii           3679  bytes
  23.  
  24. The "BrushConvertor" is a utility that will convert IFF brush/animbrush
  25. files into .CNK (CNKI) files.
  26.  
  27. The "CNKI.bb2" is an include file which contains the CNKI routines.
  28.  
  29.  
  30. DISCLAIMER:
  31. ----------
  32. THIS SOFTWARE IS FREE WARE AND CAN BE DISTRIBUTED FREELY AS LONG AS
  33. THE CONTENTS OF THIS ARCHIVE REMAIN UNALTERED, UNLESS YOU HAVE THE
  34. EXPRESSED PERMISSION OF THE AUTHOR.
  35.  
  36. THIS SOFTWARE IS TO BE USED AT YOUR OWN RISK. THE AUTHOR TAKES NO
  37. RESPONSIBILITY FOR DIRECT/INDIRECT DAMAGE OR LOSS OF DATA RESULTING
  38. FROM THE USE/MISUSE OF THIS SOFTWARE.
  39.  
  40.  
  41. Requirements:
  42. ------------
  43. To use this software you will require:
  44.  
  45. Blitz Basic 2, including libraries,
  46.  
  47. Mildred V1.48 or better, by Paul West,
  48.  
  49. An AGA! Amiga! or Amiga with GFX card :),
  50.  
  51. A Hard Drive would be nice ;),
  52.  
  53. A 68030 cpu or better is recommended, but not essential ;)
  54.  
  55.  
  56. Usage:
  57. -----
  58. The routines in this archive are to be used with "Mildred"...
  59.  
  60. *BrushConvertor:
  61.  
  62. The BrushConvertor can convert an IFF brush/animbrush file into a
  63. .CNK (CNKI) file with some very nice compression ratios eg.
  64.  
  65. IFF AnimBrush= 4210 bytes compressed to 818 bytes in .CNK file.
  66.  
  67. Please NOTE that the compression ratios vary.
  68.  
  69. To convert an IFF brush/animbrush simply execute the BrushConvertor,
  70. a file requestor will pop-up - select a brush/animbrush.
  71.  
  72. A second file requestor will pop-up asking for a destination and
  73. file name, after selecting a file name, BrushConvertor will
  74. continue to convert the choosen file, showing it's progress with a
  75. nice progress indicator :) After it has finnished it will exit.
  76.  
  77. You can set BrushConvertor to use compression or not by altering the
  78. tooltype "COMPRESSION" which can be set to YES or NO.
  79.  
  80. You can also make BrushConvertor save the palette (CMAP) of the brush/
  81. animbrush by setting the "SAVEPALETTE" tooltype to YES.
  82.  
  83.  
  84. *CNKI.bb2
  85.  
  86. Contains 2 functions. Put this file in your program's directory and add
  87. this line at the top of your program 'Include "CNKI.bb2"' :
  88.  
  89. success = LoadCNK{ shapenumber.w , filepath$ }
  90.  
  91. Loads a .CNK file into Mshapes shapenumber.w
  92.  
  93. Where shapenumber.w is the number of the Mshape you want to load into.
  94. filepath$ is the full path of the .CNK file.
  95. success returns -1 if it succeeds or one of the following error codes:
  96.  
  97. #0 = File doesn't exist / Can't read file!
  98. #1 = Not a CNKI file format!
  99. #2 = File is corrupt!
  100. #3 = Can't allocate enough fast ram!
  101. #4 = Illegal parameters!
  102.  
  103.  
  104. frames.w = CnkFrames{ filepath$ }
  105.  
  106. Returns the number of frames in a .CNK file.
  107.  
  108. Where filepath$ is the complete path of the .CNK file.
  109. frames.w returns the number of frames in the .CNK file or returns -1 for
  110. failure.
  111.  
  112.  
  113. Please NOTE that these routines use file 0 for loading so don't have a
  114. file 0 open when calling these routines :)
  115.  
  116.  
  117. Contacting the Author:
  118. ---------------------
  119. To contact me for any reason, you can email me at:
  120.  
  121. chris@addnet.demon.co.uk
  122.  
  123. Or catch me on IRC Dalnet "PrinceD"
  124. #AmIRC #Ungabunga #Amazing or /whois me :)
  125.  
  126.  
  127. Greetz!:
  128. -------
  129. Greetz goes to (in no perticular order):
  130.  
  131. Sparkster, [^CRASH^], TroySwoosh, FoxyLady, leki, Drad, Sp^, NinjA,
  132. Epsilon, and loads of other IRC buddies :)
  133.  
  134. Guys on the blitz list:
  135.  
  136. Paul West, Anton Reinauer, Gareth Griffiths, Dave Newton, Paul Burkey,
  137. Curt Esser, Mikkel Lokke, And all the other cool guyz on the list :)
  138.  
  139. Join the list, it's grrreat fun, honest :)
  140.  
  141.  
  142. ============================= Archive contents =============================
  143.  
  144. Original  Packed Ratio    Date     Time    Name
  145. -------- ------- ----- --------- --------  -------------
  146.    62232   27775 55.3% 03-Apr-99 14:33:12 +BrushConvertor
  147.     1650    1158 29.8% 03-Apr-99 18:36:34 +BrushConvertor.info
  148.     3679    1132 69.2% 03-Apr-99 17:28:24 +CNKI.ascii
  149.     3067    1088 64.5% 03-Apr-99 17:27:38 +CNKI.bb2
  150.     1222     153 87.4% 03-Apr-99 17:27:38 +CNKI.bb2.xtra
  151.     3651    1836 49.7% 03-Apr-99 18:13:18 +CNKI.readme
  152.     1369     820 40.1% 03-Apr-99 18:36:34 +CNKI.readme.info
  153.     1636     859 47.4% 03-Apr-99 18:36:34  CNKI.info
  154. -------- ------- ----- --------- --------
  155.    78506   34821 55.6% 04-Apr-99 16:09:06   8 files
  156.